Mapping GNIDs to Primary Database Keys
GVD uses several kinds of Gracenote IDs (GNIDs). The table below describes these IDs and how they map to primary database keys.
| ID |
Description |
| "Root ID" |
A general term used for the top-level GNID of an element. In general, this is the first Idlisted in the endpoint output. For example: <gvd_object>
<id>GN05ZYT1KM87411</id>
<type>CatalogItem</type>
|
| Country GNID
|
Primary key for a country.
|
| Lineup GNID
|
Primary key for a single lineup / headend.
Composite Key: [Provider | Lineup Type | Signal Type]
|
| Source GNID
|
Primary key for a Channel or VOD Source. For example, GN5KSEKRB68XJME for NBC.
|
| Catalog Item GNID
|
GNID for a program specific to a Source. Composite Key:
[Source GNID | Program Context GNID | (Schedule / VOD Qualifiers) ]
|
| Catalog Manifest GNID
|
All the programs associated to a Source (Channel / VOD) will be encapsulated in a Catalog manifest. This manifest GNID is again specific to a source.
Composite key : [Catalog Item GNID | Source GNID]
|
| Availability GNID
|
Schedule Idfor a Channel’s listings for the day. Not a timeslot ID.
Composite key : [Source GNID + Day]
|
| Availability Manifest GNID
|
A GNID for the schedule manifest (up to 14 days) for a given source.
Composite key : [Availability Day GNID | Source GNID]
|
| Program GNID
|
Root level Idfor a program that has language/country/source variants.
|
| Program Context GNID
|
Primary identifier of a program associated to a TV schedule grid or a VOD catalog. The Idis specific to [Language / Country & Language / Source].
|
| Contributor GNID
|
A Root level Idfor a Cast or Crew member.
|
| Contributor Name GNID
|
Name Idfor candidates having multiple names. For example, Robert Downey Jr.
Composite Key: [Contributor GNID + Name ]
|
| Media GNID
|
A GNID for image. Unique for an image type [Banner, Iconic, etc.], aspect ratio, dimensions.
|
| Video Descriptor Taxonomy Item GNID
|
Primary Key for a Keyword Category associated to Programs. For example, Scenario, Setting (Time Period), etc.
|
| Descriptor GNID
|
A Keyword Idthat is tagged to a Program to support Search & Recommendations use case. For example, Relationships, Love Story, Early 2010s, and so on.
|